package com.example.service;

import com.example.entity.User;

import java.util.List;

/**
 * 用户服务接口
 * @author System
 * @date 2024
 */
public interface UserService {
    
    /**
     * 用户注册
     * @param user 用户信息
     * @return 注册结果
     */
    boolean register(User user);
    
    /**
     * 用户登录
     * @param username 用户名
     * @param password 密码
     * @return 用户信息
     */
    User login(String username, String password);
    
    /**
     * 根据ID查询用户
     * @param id 用户ID
     * @return 用户信息
     */
    User getUserById(Long id);
    
    /**
     * 根据用户名查询用户
     * @param username 用户名
     * @return 用户信息
     */
    User getUserByUsername(String username);
    
    /**
     * 查询所有用户
     * @return 用户列表
     */
    List<User> getAllUsers();
    
    /**
     * 分页查询用户
     * @param page 页码
     * @param size 每页大小
     * @return 用户列表
     */
    List<User> getUsersByPage(int page, int size);
    
    /**
     * 根据关键词搜索用户
     * @param keyword 关键词
     * @return 用户列表
     */
    List<User> searchUsers(String keyword);
    
    /**
     * 统计用户总数
     * @return 用户总数
     */
    int getUserCount();
    
    /**
     * 更新用户信息
     * @param user 用户信息
     * @return 更新结果
     */
    boolean updateUser(User user);
    
    /**
     * 更新用户状态
     * @param id 用户ID
     * @param status 状态
     * @return 更新结果
     */
    boolean updateUserStatus(Long id, Integer status);
    
    /**
     * 修改密码
     * @param id 用户ID
     * @param oldPassword 旧密码
     * @param newPassword 新密码
     * @return 修改结果
     */
    boolean changePassword(Long id, String oldPassword, String newPassword);
    
    /**
     * 重置密码
     * @param id 用户ID
     * @param newPassword 新密码
     * @return 重置结果
     */
    boolean resetPassword(Long id, String newPassword);
    
    /**
     * 删除用户
     * @param id 用户ID
     * @return 删除结果
     */
    boolean deleteUser(Long id);
    
    /**
     * 批量删除用户
     * @param ids 用户ID列表
     * @return 删除结果
     */
    boolean deleteUsers(List<Long> ids);
    
    /**
     * 检查用户名是否存在
     * @param username 用户名
     * @return 是否存在
     */
    boolean isUsernameExists(String username);
    
    /**
     * 检查邮箱是否存在
     * @param email 邮箱
     * @return 是否存在
     */
    boolean isEmailExists(String email);
    
    /**
     * 验证用户密码
     * @param user 用户信息
     * @param password 密码
     * @return 验证结果
     */
    boolean validatePassword(User user, String password);
}